home *** CD-ROM | disk | FTP | other *** search
/ S1M0NE Press Kit / S1M0NE Press Kit.iso / pc / acrobat 4.0 / reader / plug_ins / acroform / javascripts / aform.js next >
Text File  |  1999-03-11  |  33KB  |  1,204 lines
  1. /*
  2.     ==========================================================================
  3.     Module: AForm.js
  4.     ==========================================================================
  5.     Pre-canned functions to map the user interface into JavaScripts.
  6.     ==========================================================================
  7.     The Software, including this file, is subject to the End User License
  8.     Agreement.
  9.     Copyright (c) 1998, Adobe Systems Incorporated, All Rights Reserved.
  10.     ==========================================================================
  11. */
  12.  
  13. console.println("Acrobat Forms Built-in Functions Version 4.0");
  14.  
  15. RE_NUMBER_ENTRY_DOT_SEP = new Array(
  16.     "[+-]?\\d*\\.?\\d*"
  17. );
  18. RE_NUMBER_COMMIT_DOT_SEP = new Array(
  19.     "[+-]?\\d+(\\.\\d+)?",        /* -1.0 or -1 */
  20.     "[+-]?\\.\\d+",                /* -.1 */
  21.     "[+-]?\\d+\\."                /* -1. */
  22. );
  23. RE_NUMBER_ENTRY_COMMA_SEP = new Array(
  24.     "[+-]?\\d*,?\\d*"
  25. );
  26. RE_NUMBER_COMMIT_COMMA_SEP = new Array(
  27.     "[+-]?\\d+([.,]\\d+)?",        /* -1,0 or -1 */
  28.     "[+-]?[.,]\\d+",                /* -,1 */
  29.     "[+-]?\\d+[.,]"                /* -1, */
  30. );
  31. RE_ZIP_ENTRY = new Array(
  32.     "\\d{0,5}"
  33. );
  34. RE_ZIP_COMMIT = new Array(
  35.     "\\d{5}"
  36. );
  37. RE_ZIP4_ENTRY = new Array(
  38.     "\\d{0,5}(\\.|[- ])?\\d{0,4}"
  39. );
  40. RE_ZIP4_COMMIT = new Array(
  41.     "\\d{5}(\\.|[- ])?\\d{4}"
  42. );
  43. RE_PHONE_ENTRY = new Array(
  44.     "\\d{0,3}(\\.|[- ])?\\d{0,3}(\\.|[- ])?\\d{0,4}",        /* 555-1234 or 408 555-1234 */
  45.     "\\(\\d{0,3}",                                            /* (408 */
  46.     "\\(\\d{0,3}\\)(\\.|[- ])?\\d{0,3}(\\.|[- ])?\\d{0,4}",    /* (408) 555-1234 */
  47.         /* (allow the addition of parens as an afterthought) */
  48.     "\\(\\d{0,3}(\\.|[- ])?\\d{0,3}(\\.|[- ])?\\d{0,4}",    /* (408 555-1234 */
  49.     "\\d{0,3}\\)(\\.|[- ])?\\d{0,3}(\\.|[- ])?\\d{0,4}",    /* 408) 555-1234 */
  50.     "011(\\.|[- \\d])*"                                        /* international */
  51. );
  52. RE_PHONE_COMMIT = new Array(
  53.     "\\d{3}(\\.|[- ])?\\d{4}",                            /* 555-1234 */
  54.     "\\d{3}(\\.|[- ])?\\d{3}(\\.|[- ])?\\d{4}",            /* 408 555-1234 */
  55.     "\\(\\d{3}\\)(\\.|[- ])?\\d{3}(\\.|[- ])?\\d{4}",    /* (408) 555-1234 */
  56.     "011(\\.|[- \\d])*"                                    /* international */
  57. );
  58. RE_SSN_ENTRY = new Array(
  59.     "\\d{0,3}(\\.|[- ])?\\d{0,2}(\\.|[- ])?\\d{0,4}"
  60. );
  61. RE_SSN_COMMIT = new Array(
  62.     "\\d{3}(\\.|[- ])?\\d{2}(\\.|[- ])?\\d{4}"
  63. );
  64.  
  65. /* Function definitions for the color object. */
  66.  
  67. function ColorConvert(oColor, cColorspace)
  68. {    // Converts a color to a specific colorspace.
  69.     var oOut = oColor;
  70.  
  71.     switch (cColorspace) {
  72.         case "G":
  73.             // Note that conversion to the DeviceGray colorspace is lossy in the same
  74.             // way that a color signal on a B/W TV is lossy.
  75.             if (oColor[0] == "RGB")
  76.                 oOut = new Array("G", 0.3 * oColor[1] + 0.59 * oColor[2] + 0.11 * oColor[3]);
  77.             else if (oColor[0] == "CMYK")
  78.                 oOut = new Array("G", 1.0 - Math.min(1.0, 
  79.                     0.3 * oColor[1] + 0.59 * oColor[2] + 0.11 * oColor[3] + oColor[4]));
  80.         break;
  81.         case "RGB":
  82.             if (oColor[0] == "G")
  83.                 oOut = new Array("RGB", oColor[1], oColor[1], oColor[1]);
  84.             else if (oColor[0] == "CMYK")
  85.                 oOut = new Array("RGB", 1.0 - Math.min(1.0, oColor[1] + oColor[4]), 
  86.                     1.0 - Math.min(1.0, oColor[2] + oColor[4]),
  87.                     1.0 - Math.min(1.0, oColor[3] + oColor[4]));
  88.         break;
  89.         case "CMYK":
  90.             if (oColor[0] == "G")
  91.                 oOut = new Array("CMYK", 0, 0, 0, 1.0 - oColor[1]);
  92.             else if (oColor[0] == "RGB")
  93.                 oOut = new Array("CMYK", 1.0 - oColor[1], 1.0 - oColor[2], 1.0 - oColor[3], 0); 
  94.         break;
  95.     }
  96.  
  97.     return oOut;
  98. }
  99.  
  100. function ColorEqual(c1, c2)
  101. {    // Compare two colors. 
  102.     /* The gray colorspace conversion is lossy so we avoid if possible. */
  103.     if (c1[0] == "G")
  104.         c1 = color.convert(c1, c2[0]);
  105.     else
  106.         c2 = color.convert(c2, c1[0]);
  107.  
  108.     /* Colorspace must be equal. */
  109.     if (c1[0] != c2[0])    {
  110.         return false;
  111.     }
  112.  
  113.     /* Compare the individual components. */
  114.     var nComponents = 0;
  115.         
  116.     switch (c1[0]) {
  117.         case "G":
  118.             nComponents = 1;
  119.         break;
  120.         case "RGB":
  121.             nComponents = 3;
  122.         break;
  123.         case "CMYK":
  124.             nComponents = 4;
  125.         break;
  126.     }
  127.  
  128.     for (var i = 1; i <= nComponents; i++) {
  129.         if (c1[i] != c2[i])    {
  130.             return false;
  131.         }
  132.     }
  133.  
  134.     return true;
  135. }
  136.  
  137. /* ==== Convenience Objects ==== */
  138.  
  139. /* Stock color definitions for ease of use. */
  140. color = new Object();
  141. color.equal = ColorEqual;
  142. color.convert = ColorConvert;
  143. color.transparent = new Array("T");
  144. color.black = new Array("G", 0);
  145. color.white = new Array("G", 1);
  146. color.dkGray = new Array("G", 0.25);
  147. color.gray = new Array("G", 0.5);
  148. color.ltGray = new Array("G", 0.75);
  149. color.red = new Array("RGB", 1, 0, 0);
  150. color.green = new Array("RGB", 0, 1, 0);
  151. color.blue = new Array("RGB", 0, 0, 1);
  152. color.cyan = new Array("CMYK", 1, 0, 0, 0);
  153. color.magenta = new Array("CMYK", 0, 1, 0, 0);
  154. color.yellow = new Array("CMYK", 0, 0, 1, 0);
  155.  
  156. /* Font definitions for ease of use */
  157. font = new Object();
  158. font.Times = "Times-Roman";
  159. font.TimesB = "Times-Bold";
  160. font.TimesI = "Times-Italic";
  161. font.TimesBI = "Times-BoldItalic";
  162. font.Helv = "Helvetica";
  163. font.HelvB = "Helvetica-Bold";
  164. font.HelvI = "Helvetica-Oblique";
  165. font.HelvBI = "Helvetica-BoldOblique";
  166. font.Cour = "Courier";
  167. font.CourB = "Courier-Bold";
  168. font.CourI = "Courier-Oblique";
  169. font.CourBI = "Courier-BoldOblique";
  170. font.Symbol = "Symbol";
  171. font.ZapfD = "ZapfDingbats";
  172. font.KaGo = "HeiseiKakuGo-W5-UniJIS-UCS2-H";
  173. font.KaMi = "HeiseiMin-W3-UniJIS-UCS2-H";
  174.  
  175. /* Border style definitions for ease of use */
  176. border = new Object();
  177. border.s = "solid";
  178. border.d = "dashed";
  179. border.b = "beveled";
  180. border.i = "inset";
  181. border.u = "underline";
  182.  
  183. /* Radio/Check button style definitions for ease of use */
  184. style = new Object();
  185. style.ch = "check";
  186. style.cr = "cross";
  187. style.di = "diamond";
  188. style.ci = "circle";
  189. style.st = "star";
  190. style.sq = "square"; 
  191.  
  192. /* highlight modes of on a push button */
  193. highlight = new Object();
  194. highlight.n = "none";
  195. highlight.i = "invert";
  196. highlight.p = "push";
  197. highlight.o = "outline";
  198.  
  199. /* zoom types for a document */
  200. zoomtype = new Object();
  201. zoomtype.none = "NoVary";
  202. zoomtype.fitW = "FitWidth";
  203. zoomtype.fitH = "FitHeight";
  204. zoomtype.fitP = "FitPage";
  205. zoomtype.fitV = "FitVisibleWidth";
  206. zoomtype.pref = "Preferred";
  207.  
  208. /* Cursor behavior in full screen mode. */
  209. cursor = new Object();
  210. cursor.visible = 0;
  211. cursor.hidden = 1;
  212. cursor.delay = 2;
  213.  
  214. /* Transition definitions. */
  215. trans = new Object();
  216. trans.blindsH        = "Blinds Horizontal";
  217. trans.blindsV        = "Blinds Vertical";
  218. trans.boxI            = "Box In";
  219. trans.boxO            = "Box Out";
  220. trans.dissolve        = "Dissolve";
  221. trans.glitterD        = "Glitter Down";
  222. trans.glitterR        = "Glitter Right";
  223. trans.glitterRD        = "Glitter Right-Down";
  224. trans.none            = "No Transition";
  225. trans.random        = "Random Transition";
  226. trans.replace        = "Replace";
  227. trans.splitHI        = "Split Horizontal In";
  228. trans.splitHO        = "Split Horizontal Out";
  229. trans.splitVI        = "Split Vertical In";
  230. trans.splitVO        = "Split Vertical Out";
  231. trans.wipeD            = "Wipe Down";
  232. trans.wipeL            = "Wipe Left";
  233. trans.wipeR            = "Wipe Right";
  234. trans.wipeU            = "Wipe Up";
  235.  
  236. /* Icon/Text placement. */
  237. position = new Object();
  238. position.textOnly    = 0;
  239. position.iconOnly    = 1;
  240. position.iconTextV    = 2;
  241. position.textIconV    = 3;
  242. position.iconTextH    = 4;
  243. position.textIconH    = 5;
  244. position.overlay    = 6;
  245.  
  246. /* When does icon scale. */
  247. scaleWhen = new Object();
  248. scaleWhen.always    = 0;
  249. scaleWhen.never        = 1;
  250. scaleWhen.tooBig    = 2;
  251. scaleWhen.tooSmall    = 3;
  252.  
  253. /* How does icon scale. */
  254. scaleHow = new Object();
  255. scaleHow.proportional    = 0;
  256. scaleHow.anamorphic        = 1;
  257.  
  258.  
  259. /* Field display. */
  260. display = new Object();
  261. display.visible        = 0;
  262. display.hidden        = 1;
  263. display.noPrint        = 2;
  264. display.noView        = 3;
  265.  
  266. /* ==== Functions ==== */
  267.  
  268. /* these may be used a lot -- they are language independent */
  269.  
  270. AFDigitsRegExp = new RegExp();
  271. AFDigitsRegExp.compile("\\d+");
  272. AFPMRegExp = new RegExp();
  273. AFPMRegExp.compile(IDS_PM, "i");
  274. AFAMRegExp = new RegExp();
  275. AFAMRegExp.compile(IDS_AM, "i");
  276. AFTimeLongRegExp = new RegExp();
  277. AFTimeLongRegExp.compile("\\d{1,2}:\\d{1,2}:\\d{1,2}");
  278. AFTimeShortRegExp = new RegExp();
  279. AFTimeShortRegExp.compile("\\d{1,2}:\\d{1,2}");
  280.  
  281. function AFBuildRegExps(array)
  282. /* Takes an array of strings and turns it into an array of compiled regular
  283.  * expressions -- is used for the definitions that follow */
  284. {
  285.     var retVal = new Array();
  286.  
  287.     retVal.length = array.length;
  288.     for(var it = 0; it < array.length; it++)
  289.     {
  290.         retVal[it] = new RegExp();
  291.         retVal[it].compile(array[it], "i");
  292.     }
  293.     return retVal;
  294. }
  295.  
  296. /* these may be used a lot -- they are NOT language independent and are 
  297.  * derived from the localizable (RE_xxx) stuff above */
  298.  
  299. AFNumberDotSepEntryRegExp = AFBuildRegExps(RE_NUMBER_ENTRY_DOT_SEP);
  300. AFNumberDotSepCommitRegExp = AFBuildRegExps(RE_NUMBER_COMMIT_DOT_SEP);
  301. AFNumberCommaSepEntryRegExp = AFBuildRegExps(RE_NUMBER_ENTRY_COMMA_SEP);
  302. AFNumberCommaSepCommitRegExp = AFBuildRegExps(RE_NUMBER_COMMIT_COMMA_SEP);
  303. AFZipEntryRegExp = AFBuildRegExps(RE_ZIP_ENTRY);
  304. AFZipCommitRegExp = AFBuildRegExps(RE_ZIP_COMMIT);
  305. AFZip4EntryRegExp = AFBuildRegExps(RE_ZIP4_ENTRY);
  306. AFZip4CommitRegExp = AFBuildRegExps(RE_ZIP4_COMMIT);
  307. AFPhoneEntryRegExp = AFBuildRegExps(RE_PHONE_ENTRY);
  308. AFPhoneCommitRegExp = AFBuildRegExps(RE_PHONE_COMMIT);
  309. AFSSNEntryRegExp = AFBuildRegExps(RE_SSN_ENTRY);
  310. AFSSNCommitRegExp = AFBuildRegExps(RE_SSN_COMMIT);
  311. AFMonthsRegExp = AFBuildRegExps(IDS_MONTH_INFO.split(/\[\d+\]/));
  312.  
  313. function AFExactMatch(rePatterns, sString)
  314. {    /* match a string against an array of RegExps */
  315.     var it;
  316.  
  317.     if(!rePatterns.length && rePatterns.test(sString) && RegExp.lastMatch == sString)
  318.         return true;
  319.     for(it = 0; it < rePatterns.length; it++)
  320.         if(rePatterns[it].test(sString) && RegExp.lastMatch == sString)
  321.             return it + 1;
  322.     return 0;
  323. }
  324.  
  325. function AFExtractNums(string)
  326. {    /* returns an array of numbers that it managed to extract from the given 
  327.      * string or null on failure */
  328.     var nums = new Array();
  329.  
  330.     if (string.charAt(0) == '.' || string.charAt(0) == ',')
  331.         string = "0" + string;
  332.          
  333.     while(AFDigitsRegExp.test(string)) {
  334.         nums.length++;
  335.         nums[nums.length - 1] = RegExp.lastMatch;
  336.         string = RegExp.rightContext;
  337.     }
  338.     if(nums.length >= 1) return nums;
  339.     return null;
  340. }
  341.  
  342. function AFMakeNumber(string)
  343. {    /* attempts to make a number out of a string that may not use '.' as the
  344.      * seperator; it expects that the number is fairly well-behaved other than
  345.      * possibly having a non-JavaScript friendly separator */
  346.     var type = typeof string;
  347.  
  348.     if (type == "number")
  349.         return string;
  350.     if (type != "string")
  351.         return null;
  352.  
  353.     var array = AFExtractNums(string);
  354.  
  355.     if(array)
  356.     {
  357.         var joined = array.join(".");
  358.  
  359.         if (string.indexOf("-.") >= 0)
  360.             joined = "0." + joined;
  361.         return joined * (string.indexOf("-") >= 0 ? -1.0 : 1.0);
  362.     }
  363.     else
  364.         return null;
  365. }
  366.  
  367. function AFExtractRegExp(rePattern, string)
  368. {    /* attempts to match the pattern given against the string given; on 
  369.      * success, returns an array containing (at index 0) the initial
  370.      * string with the matched text removed and (at index 1) the matched
  371.      * text; on failure, returns null */
  372.     var retVal = new Array();
  373.  
  374.     if(rePattern.test(string))
  375.     {
  376.         retVal.length = 2;
  377.         retVal[0] = RegExp.leftContext + RegExp.rightContext;
  378.         retVal[1] = RegExp.lastMatch;
  379.         return retVal;
  380.     }
  381.     return null;
  382. }
  383.  
  384. function AFMakeArrayFromList(string)
  385. {
  386.   var type = typeof string;
  387.  
  388.   if(type == "string")
  389.   {
  390.      var reSep = new RegExp();
  391.     reSep.compile(",[ ]?");
  392.     return string.split(reSep);
  393.   }
  394.   return string;
  395. }
  396.  
  397. function AFExtractTime(string)
  398. {    /* attempts to extract a WELL FORMED time from a string; returned 
  399.      * is an array in the same vein as AFExtractRegExp or null on
  400.      * failure. a WELL FORMED time looks like 12:23:56pm */
  401.     
  402.     var pm = "";
  403.     var info;
  404.  
  405.     info = AFExtractRegExp(AFPMRegExp, string);
  406.     if(info)
  407.     {
  408.         pm = info[1];
  409.         string = info[0];
  410.     }
  411.     info = AFExtractRegExp(AFAMRegExp, string);
  412.     if(info)
  413.     {
  414.         string = info[0];
  415.     }
  416.     info = AFExtractRegExp(AFTimeLongRegExp, string);
  417.     if(info)
  418.     {
  419.         info[1] += pm;
  420.         return info;
  421.     }
  422.     info = AFExtractRegExp(AFTimeShortRegExp, string);
  423.     if(info)
  424.     {
  425.         info[1] += pm;
  426.         return info;
  427.     }
  428.  
  429.     return null;
  430. }
  431.  
  432. function AFGetMonthIndex(string)
  433. {    /* attempts to identify the given string as a month or a valid abbreviation,
  434.      * it expects the given string to be the valid month from the matced RegExp.
  435.      * returns the month index (January = 1) or zero on failure */
  436.     var monthre = new RegExp(string + "\\[(\\d+)\\]", "i");
  437.     var result = monthre.exec(IDS_MONTH_INFO);
  438.     
  439.     if(string && result) return 1.0 * result[1];
  440.     return 0;
  441. }
  442.  
  443. function AFMatchMonth(string)
  444. {    /* attempts to find a valid month embedded in a string; returns the month
  445.      * index (January = 1) or zero on failure */
  446.  
  447.     for(var it = 0; it < AFMonthsRegExp.length; it++)
  448.         if(AFMonthsRegExp[it].test(string))
  449.             return AFGetMonthIndex(RegExp.lastMatch);
  450.     return 0;
  451. }
  452.  
  453. function AFGetMonthString(index)
  454. {    /* returns the string corresponding to the given month or a string that
  455.      * is indicative of the fact that the index was invalid */
  456.     var monthre = new RegExp("(\\w+)\\[" + index + "\\]");
  457.     var result = monthre.exec(IDS_MONTH_INFO);
  458.  
  459.     if(result) return result[1];
  460.     return IDS_INVALID_MONTH;
  461. }
  462.  
  463. function AFParseTime(string, date)
  464. {    /* attempts to parse a string containing a time; returns null on failure
  465.      * or a Date object on success. Time can be in ugly format. */
  466.     var pm, am;
  467.     var nums = AFExtractNums(string);
  468.     if (!date)
  469.         date = new Date();
  470.     var hour;
  471.  
  472.     if(!string) return date;
  473.     if(!nums) return null;
  474.     if(nums.length < 2 || nums.length > 3) return null;
  475.     if(AFPMRegExp.test(string)) pm = true;
  476.     else pm = false;
  477.     if(AFAMRegExp.test(string)) am = true;
  478.     else am = false;
  479.     hour = new Number(nums[0]); /* force it to number */
  480.     if(pm)
  481.     {
  482.         if(hour < 12) hour += 12;
  483.     }
  484.     else if (am)
  485.     {
  486.         if(hour >= 12) hour -= 12;
  487.     }
  488.     date.setHours(hour);
  489.     date.setMinutes(nums[1]);
  490.     if(nums.length == 3) date.setSeconds(nums[2]);
  491.     else date.setSeconds(0);
  492.     return date;
  493. }
  494.  
  495. function AFParseDateEx(cString, cOrder)
  496. {    /* Attempts to parse a string containing some form of date; returns null
  497.     ** on failure or a Date object on success. cOrder should be the order in
  498.     ** which the date is entered (e.g. ymd, mdy, etc.). Use AFParseDateOrder to
  499.     ** generate this string from an arbitrary format string. */
  500.     var nYear;
  501.     var nMonth;
  502.     var nDate;
  503.     var nYCount;
  504.     var dDate = new Date();
  505.     dDate.setHours(12, 0, 0);
  506.  
  507.     /* Empty string returns current date/time. */
  508.     if (!cString) { 
  509.         return dDate;
  510.     }
  511.  
  512.     nYCount = AFParseDateYCount(cOrder); /* count the number of digits for year in the selected format */
  513.     cOrder = AFParseDateOrder(cOrder); /* make sure its in the "ymd" format */
  514.  
  515.     /* Extract any time information in the string. */
  516.     var info = AFExtractTime(cString);
  517.     if (info)
  518.         cString = info[0];
  519.  
  520.     /* Break down the date into an array of numbers. */
  521.     var aNums = AFExtractNums(cString);
  522.     if(!aNums) 
  523.         return null;    /* No numbers? */
  524.  
  525.     /* User supplied three numbers. */
  526.     if (aNums.length == 3) {
  527.         nYear = 1.0 * aNums[cOrder.indexOf("y")];
  528.         if (nYCount > 2 && nYear < 100)
  529.             return null; /* must enter 4 digits for the year to match with the format of the field */
  530.         nYear = AFDateHorizon(nYear);
  531.  
  532.         dDate.setFullYear(nYear, aNums[cOrder.indexOf("m")] - 1, aNums[cOrder.indexOf("d")]);
  533.         if (info) {
  534.             AFParseTime(info[1], dDate);
  535.         }
  536.         return dDate;
  537.     }
  538.  
  539.     /* Find text based month, if supplied. */
  540.     nMonth = AFMatchMonth(cString);    
  541.  
  542.     /* User supplied two numbers. */
  543.     if(aNums.length == 2) {
  544.         if (nMonth) {
  545.             /* Easy case, the month was text and we have two numbers. */
  546.             if (cOrder.indexOf("y") < cOrder.indexOf("d")) {
  547.                 nYear = 1.0 * aNums[0];
  548.                 nDate = aNums[1];
  549.             } else {
  550.                 nYear = 1.0 * aNums[1];
  551.                 nDate = aNums[0];
  552.             }
  553.             if (nYCount > 2 && nYear < 100)
  554.                 return null; /* must enter 4 digits for the year to match with the format of the field */
  555.         
  556.             nYear = AFDateHorizon(nYear);
  557.             dDate.setFullYear(nYear, nMonth - 1, nDate);
  558.  
  559.             if (info)
  560.                 AFParseTime(info[1], dDate);
  561.             return dDate;
  562.         }
  563.  
  564.         /* More difficult case. We have two numbers and three slots, how
  565.         ** to allocate them? */
  566.         if (cOrder.indexOf("y") < cOrder.indexOf("d"))    {
  567.             /* Year comes before date and as such we allocate the two
  568.             ** numbers to the month and the year only. */
  569.             if (cOrder.indexOf("y") < cOrder.indexOf("m")) {
  570.                 nYear = 1.0 * aNums[0];
  571.                 nMonth = aNums[1];
  572.             } else {
  573.                 nYear = 1.0 * aNums[1];
  574.                 nMonth = aNums[0];
  575.             }
  576.             if (nYCount > 2 && nYear < 100)
  577.                 return null; /* must enter 4 digits for the year to match with the format of the field */
  578.         
  579.             nYear = AFDateHorizon(nYear);
  580.             dDate.setFullYear(nYear, nMonth - 1, 1);
  581.         } else {
  582.             /* Date comes before year and so we allocate the two numbers
  583.             ** to the date and the month only. */
  584.             nYear = dDate.getFullYear();
  585.             if (cOrder.indexOf("d") < cOrder.indexOf("m")) {
  586.                 dDate.setFullYear(nYear, aNums[1] - 1, aNums[0]);
  587.             } else {
  588.                 dDate.setFullYear(nYear, aNums[0] - 1, aNums[1]);
  589.             }
  590.         }
  591.     
  592.         if (info)
  593.             AFParseTime(info[1], dDate);
  594.         return dDate;
  595.     }
  596.  
  597.     /* User supplied one number. */
  598.     if(aNums.length == 1)    {
  599.         if (nMonth) {
  600.             /* We have one number and two slots (y/d) and need to allocate
  601.             ** them based on who came first in the format. */
  602.             if(cOrder.indexOf("y") < cOrder.indexOf("d")) {
  603.                 nYear = 1.0 * aNums[0];
  604.                 if (nYCount > 2 && nYear < 100)
  605.                     return null; /* must enter 4 digits for the year to match with the format of the field */
  606.             
  607.                 nYear = AFDateHorizon(nYear);
  608.                 dDate.setFullYear(nYear, nMonth - 1, 1);
  609.             } else {
  610.                 nYear = dDate.getFullYear();
  611.                 dDate.setFullYear(nYear, nMonth - 1, aNums[0]);
  612.             }
  613.             if (info)
  614.                 AFParseTime(info[1], date);
  615.             return dDate;
  616.         }
  617.  
  618.         /* We have one number and three slots and need to allocate them
  619.         ** based on who came first in the format. */
  620.         nYear = dDate.getFullYear();
  621.         nMonth = dDate.getMonth();
  622.         nDate = dDate.getDate();
  623.         switch (cOrder.charAt(0)) {
  624.             case "y":
  625.                 nYear = 1.0 * aNums[0];
  626.                 if (nYCount > 2 && nYear < 100)
  627.                     return null; /* must enter 4 digits for the year to match with the format of the field */
  628.             
  629.                 nYear = AFDateHorizon(nYear);
  630.             break;
  631.             case "m":
  632.                 nMonth = aNums[0] - 1;
  633.             break;
  634.             case "d":
  635.                 nDate = aNums[0];
  636.             break;
  637.         }
  638.         dDate.setFullYear(nYear, nMonth, nDate);
  639.  
  640.  
  641.         if (info)
  642.             AFParseTime(info[1], date);
  643.         return dDate;
  644.     }
  645.  
  646.     /* No idea how to deal with the other combinations. */
  647.     return null;
  648. }
  649.  
  650. function AFDateHorizon(nYear)
  651. {    /* Takes the year supplied and applies the date horizon heuristic.
  652.     ** All years between 50 and 100 we add 1900. All years less than 50 we add 2000. */
  653.     if (nYear < 100 && nYear >= 50) {
  654.         nYear += 1900;
  655.     } else if (nYear >= 0 && nYear < 50) {
  656.         nYear += 2000;
  657.     }
  658.  
  659.     return nYear;
  660. }
  661.  
  662. function AFParseDate(string, longEntry, shortEntry, wordMonthEntry, monthYearEntry)
  663. {    /* OBSOLETE: Use AFParseDateEx instead. */
  664.     var nums;
  665.     var year, month;
  666.     var date;
  667.     var info = AFExtractTime(string);
  668.  
  669.     if(!string) return new Date();
  670.  
  671.     if(info)
  672.         string = info[0];
  673.  
  674.     date = new Date();
  675.     nums = AFExtractNums(string);
  676.     if(!nums) return null;
  677.     if(nums.length == 3)
  678.     {
  679.         year = 1.0 * nums[eval(longEntry.charAt(0))];
  680.         year = AFDateHorizon(year);
  681.         date.setFullYear(year, nums[eval(longEntry.charAt(1))] - 1, nums[eval(longEntry.charAt(2))]);
  682.         if (info)
  683.             AFParseTime(info[1], date);
  684.         return date;
  685.     }
  686.     month = AFMatchMonth(string);
  687.     if(nums.length == 2)
  688.     {
  689.         if(month)
  690.         {
  691.             year = 1.0 * nums[eval(wordMonthEntry.charAt(0))];
  692.             year = AFDateHorizon(year);
  693.             date.setFullYear(year, month - 1, nums[eval(wordMonthEntry.charAt(1))]);
  694.             if (info)
  695.                 AFParseTime(info[1], date);
  696.             return date;
  697.         }
  698.         if(monthYearEntry)
  699.         {
  700.             year = 1.0 * nums[eval(monthYearEntry.charAt(0))];
  701.             year = AFDateHorizon(year);
  702.             date.setFullYear(year, nums[eval(monthYearEntry.charAt(1))] - 1, 1);
  703.         }
  704.         else
  705.         {
  706.             date.setMonth(nums[eval(shortEntry.charAt(0))] - 1);
  707.             date.setDate(nums[eval(shortEntry.charAt(1))]);
  708.         }
  709.         if (info)
  710.             AFParseTime(info[1], date);
  711.         return date;
  712.     }
  713.     if(month && nums.length == 1)
  714.     {
  715.         if(monthYearEntry)
  716.         {
  717.             year = 1.0 * nums[0];
  718.             year = AFDateHorizon(year);
  719.             date.setFullYear(year, month - 1, 1);
  720.         }
  721.         else
  722.         {
  723.             date.setMonth(month - 1);
  724.             date.setDate(nums[0]);
  725.         }
  726.         if (info)
  727.             AFParseTime(info[1], date);
  728.         return date;
  729.     }
  730.  
  731.     return null;
  732. }
  733.  
  734. function AFParseDateWithPDF(value, pdf)
  735. { /* OBSOLETE: Use AFParseDateEx instead. */
  736.     var cOldFormats = new Array(
  737.         "m/d", "m/d/yy", "mm/dd/yy", "mm/yy", "d-mmm", "d-mmm-yy", "dd-mmm-yy",
  738.         "yy-mm-dd", "mmm-yy", "mmmm-yy", "mmm d, yyyy", "mmmm d, yyyy",
  739.         "m/d/yy h:MM tt", "m/d/yy HH:MM" );
  740.    
  741.     return AFParseDateEx(value, cOldFormats[pdf]);
  742. }
  743.  
  744. function AFMergeChange(event)
  745. {    /* merges the last change with the uncommitted change */
  746.     var prefix, postfix;
  747.     var value = event.value;
  748.  
  749.     if(event.willCommit) return event.value;
  750.     if(event.selStart >= 0)
  751.         prefix = value.substring(0, event.selStart);
  752.     else prefix = "";
  753.     if(event.selEnd >= 0 && event.selEnd <= value.length)
  754.         postfix = value.substring(event.selEnd, value.length);
  755.     else postfix = "";
  756.     return prefix + event.change + postfix;
  757. }
  758.  
  759. function AFRange_Validate(bGreaterThan, nGreaterThan, bLessThan, nLessThan)
  760. {       /* This function validates the current event to ensure that its value is 
  761.     ** within the specified range. */
  762.     var cError = "";
  763.  
  764.     if (event.value == "")
  765.         return;
  766.  
  767.     if (bGreaterThan && bLessThan) {
  768.         if (event.value < nGreaterThan || event.value > nLessThan)
  769.             cError = util.printf(IDS_GT_AND_LT, nGreaterThan, nLessThan);
  770.     } else if (bGreaterThan) {
  771.         if (event.value < nGreaterThan)
  772.             cError = util.printf(IDS_GREATER_THAN, nGreaterThan);
  773.     } else if (bLessThan) {
  774.         if (event.value > nLessThan)
  775.             cError = util.printf(IDS_LESS_THAN, nLessThan);
  776.     }
  777.     
  778.     if (cError != "") {
  779.         app.alert(cError, 0);
  780.         event.rc = false;
  781.     }
  782. }
  783.  
  784. function AFSimpleInit(cFunction)
  785. {    /* Convenience function used by AFSimple_Calculate. */
  786.     switch (cFunction)
  787.     {
  788.         case "PRD":
  789.             return 1.0;
  790.             break;
  791.     }
  792.  
  793.     return 0.0;
  794. }
  795.  
  796. function AFSimple(cFunction, nValue1, nValue2)
  797. {    /* Convenience function used by AFSimple_Calculate. */
  798.     var nValue = 1.0 * nValue1;
  799.  
  800.     /* Have to do this otherwise JavaScript thinks it's dealing with strings. */
  801.     nValue1 = 1.0 * nValue1;
  802.     nValue2 = 1.0 * nValue2;
  803.  
  804.     switch (cFunction)
  805.     {
  806.         case "AVG":
  807.         case "SUM":
  808.             nValue = nValue1 + nValue2;
  809.             break;
  810.         case "PRD":
  811.             nValue = nValue1 * nValue2;
  812.             break;
  813.         case "MIN":
  814.             nValue = Math.min(nValue1,nValue2);
  815.             break;
  816.         case "MAX":
  817.             nValue = Math.max(nValue1, nValue2);
  818.             break;
  819.     }
  820.  
  821.     return nValue;
  822. }
  823.  
  824. function AFSimple_Calculate(cFunction, cFields)
  825. {   /* Calculates the sum, average, product, etc. of the listed field values. */
  826.     var nFields = 0;
  827.     var nValue = AFSimpleInit(cFunction);
  828.  
  829.     /* Field name separator is one or more spaces followed by a comma, 
  830.     ** followed by one or more spaces.
  831.     ** or an array of field names */
  832.      var aFields = AFMakeArrayFromList(cFields);
  833.  
  834.     for (var i = 0; i < aFields.length; i++) {
  835.         /* Found a field, process it's value. */
  836.         var f = this.getField(aFields[i]);
  837.         var a = f.getArray();
  838.  
  839.         for (var j = 0; j < a.length; j++) {
  840.             var nTemp = AFMakeNumber(a[j].value); 
  841.             if (i == 0 && j == 0 && (cFunction == "MIN" || cFunction == "MAX"))
  842.                 nValue = nTemp;
  843.             nValue = AFSimple(cFunction, nValue, nTemp);
  844.             nFields++;
  845.         }
  846.     }
  847.  
  848.     if (cFunction == "AVG" && nFields > 0)
  849.         nValue /= nFields;
  850.  
  851.     event.value = nValue;
  852. }
  853.  
  854. function AFNumber_Keystroke(nDec, sepStyle, negStyle, currStyle, strCurrency, bCurrencyPrepend)
  855. {       /* This function validates the current keystroke event to make sure the
  856.         key pressed is reasonable for a numeric field. */
  857.  
  858.     var value = AFMergeChange(event);
  859.     var commit, noCommit;
  860.  
  861.     if(!value) return;
  862.     if(sepStyle > 1)
  863.     {
  864.         commit = AFNumberCommaSepCommitRegExp;
  865.         noCommit = AFNumberCommaSepEntryRegExp;
  866.     }
  867.     else
  868.     {
  869.         commit = AFNumberDotSepCommitRegExp;
  870.         noCommit = AFNumberDotSepEntryRegExp;
  871.     }
  872.     if(!AFExactMatch(event.willCommit ? commit : noCommit, value))
  873.     {
  874.         if (event.willCommit)
  875.             app.alert(IDS_INVALID_VALUE + " [ " + event.target.name + " ]", 0);
  876.         else
  877.             app.beep(0);
  878.         event.rc = false;
  879.     }
  880. }
  881.  
  882. function AFPercent_Keystroke(nDec, sepStyle)
  883. {
  884.         AFNumber_Keystroke(nDec, sepStyle, 0, 0, "", true);
  885. }
  886.  
  887. function AFSpecial_Keystroke(psf)
  888. {       /* This function validates the current keystroke event to make sure the
  889.         key pressed is reasonable for a "special" field. */
  890.         
  891.     /* The special formats, indicated by psf, are:
  892.     
  893.     psf             format
  894.     ---             ------
  895.     0               zip code
  896.     1               zip + 4
  897.     2               phone
  898.     3                SSN
  899.     
  900.     */
  901.  
  902.     var value = AFMergeChange(event);
  903.     var commit, noCommit;
  904.  
  905.     if(!value) return;
  906.     switch (psf)
  907.     {
  908.         case 0:
  909.             commit = AFZipCommitRegExp;
  910.             noCommit = AFZipEntryRegExp;
  911.             break;
  912.         case 1:
  913.             commit = AFZip4CommitRegExp;
  914.             noCommit = AFZip4EntryRegExp;
  915.             break;
  916.         case 2:
  917.             commit = AFPhoneCommitRegExp;
  918.             noCommit = AFPhoneEntryRegExp;
  919.             break;
  920.         case 3:
  921.             commit = AFSSNCommitRegExp;
  922.             noCommit = AFSSNEntryRegExp;
  923.             break;
  924.     }        
  925.     if(!AFExactMatch(event.willCommit ? commit : noCommit, value))
  926.     {
  927.         if (event.willCommit)
  928.             app.alert(IDS_INVALID_VALUE + " [ " + event.target.name + " ]", 0);
  929.         else
  930.             app.beep(0);
  931.         event.rc = false;
  932.     }
  933. }
  934.  
  935. function AFDate_KeystrokeEx(cFormat)
  936. {    /* This function validates the current keystroke event to make sure the
  937.     ** key pressed is reasonable for a date field. */
  938.     if(event.willCommit && !AFParseDateEx(AFMergeChange(event), cFormat)) {
  939.         /* Dates are only validated on commit */
  940.         if (event.willCommit)
  941.             app.alert(IDS_INVALID_VALUE + " [ " + event.target.name + " ]", 0);
  942.         else
  943.             app.beep(0);
  944.         event.rc = false;
  945.     }
  946. }
  947.  
  948. function AFDate_Keystroke(pdf)
  949. {    /* OBSOLETE: Use AFDate_KeystrokeEx. */
  950.     var cOldFormats = new Array(
  951.         "m/d", "m/d/yy", "mm/dd/yy", "mm/yy", "d-mmm", "d-mmm-yy", "dd-mmm-yy",
  952.         "yy-mm-dd", "mmm-yy", "mmmm-yy", "mmm d, yyyy", "mmmm d, yyyy",
  953.         "m/d/yy h:MM tt", "m/d/yy HH:MM" );
  954.  
  955.     AFDate_KeystrokeEx(cOldFormats[pdf]);
  956. }
  957.  
  958. function AFTime_Keystroke(ptf)
  959. {    /* This function validates the current keystroke event to make sure the
  960.     key pressed is reasonable for a time field. */
  961.  
  962.     if(event.willCommit && !AFParseTime(event.value, null))
  963.                     /* times are only validated on commit */
  964.     {
  965.         if (event.willCommit)
  966.             app.alert(IDS_INVALID_VALUE + " [ " + event.target.name + " ]", 0);
  967.         else
  968.             app.beep(0);
  969.         event.rc = false;
  970.     }
  971. }
  972.  
  973. function AFNumber_Format(nDec, sepStyle, negStyle, currStyle, strCurrency, bCurrencyPrepend)
  974. {       /* This function formats a numeric value according to the parameters. */
  975.  
  976.     var value = AFMakeNumber(event.value);
  977.     var sign = (value < 0 ? -1 : 1);
  978.     var f = event.target;
  979.  
  980.     if(value == null)
  981.     {
  982.         event.value = "";
  983.         return;
  984.     }    
  985.     if ((negStyle == 2 /* ParensBlack */ || negStyle == 3 /* ParensRed */) && value < 0)
  986.         var formatStr = "(";
  987.     else 
  988.         var formatStr = "";
  989.     
  990.     if (bCurrencyPrepend)
  991.         formatStr = formatStr + strCurrency;
  992.         
  993.     formatStr = formatStr + "%," + sepStyle + "." + nDec + "f";
  994.     if (! bCurrencyPrepend)
  995.         formatStr = formatStr + strCurrency;
  996.         
  997.     if ((negStyle == 2 /* ParensBlack */ || negStyle == 3 /* ParensRed */) && value < 0)
  998.         formatStr = formatStr + ")";
  999.  
  1000.     if (negStyle != 0 /* MinusBlack */ || bCurrencyPrepend)
  1001.         value = Math.abs(value);
  1002.         
  1003.     if (negStyle == 1 /* Red */ || negStyle == 3 /* ParensRed */) {
  1004.         if (sign > 0 )
  1005.             f.fgColor = color.black;
  1006.         else 
  1007.             f.fgColor = color.red;
  1008.     }
  1009.  
  1010.     var tmp = util.printf(formatStr, value);
  1011.     if (sign < 0 && bCurrencyPrepend && negStyle == 0)
  1012.         tmp = '-' + tmp; /* prepend the -ve sign */
  1013.     event.value = tmp;
  1014. }
  1015.  
  1016. function AFPercent_Format(nDec, sepStyle)
  1017. {       /* This function formats a percentage value according to the parameters. */
  1018.  
  1019.     var value = AFMakeNumber(event.value) * 100;
  1020.     
  1021.     var formatStr = "%," + sepStyle + "." + nDec + "f";
  1022.         
  1023.     if(value == null)
  1024.     {
  1025.         event.value = "";
  1026.         return;
  1027.     }    
  1028.  
  1029.     value = util.printf(formatStr, value);
  1030.     
  1031.     event.value = value + "%";
  1032. }
  1033.  
  1034. function AFSpecial_Format(psf)
  1035. {   /* This function formats a "special" value according to the "PropsSpecialFormat" parameter psf. */
  1036.     /* The special formats, indicated by psf, are: 0 = zip code, 1 = zip + 4, 2 = phone, 3 = SSN. */
  1037.     var value = event.value;
  1038.  
  1039.     if(!value) return;    
  1040.     switch (psf) {
  1041.     
  1042.         case 0:                         
  1043.             var formatStr = "99999";
  1044.             break;
  1045.         case 1:                         
  1046.             var formatStr = "99999-9999";
  1047.             break;
  1048.         case 2:                         /* must distinguish between 2 styles: with and without area code */
  1049.             var NumbersStr = util.printx("9999999999", value);      /* try to suck out 10 numeric chars */
  1050.             if (NumbersStr.length >= 10 )
  1051.                 var formatStr = "(999) 999-9999";
  1052.             else 
  1053.                 var formatStr = "999-9999";
  1054.             break;
  1055.         case 3:
  1056.             var formatStr = "999-99-9999";
  1057.             break;
  1058.     }
  1059.         
  1060.     event.value = util.printx(formatStr, value);
  1061. }
  1062.  
  1063. function AFParseDateYCount(cFormat)
  1064. {
  1065.     /* Determine the order of the date. */
  1066.     var yCount = 0;
  1067.     for (var i = 0; i < cFormat.length; i++) {
  1068.         switch (cFormat.charAt(i)) {
  1069.             case "\\":    /* Escape character. */
  1070.                 i++;
  1071.             break;
  1072.             case "y":
  1073.                 yCount += 1;
  1074.             break;
  1075.         }
  1076.     }
  1077.     return yCount;
  1078. }
  1079.  
  1080. function AFParseDateOrder(cFormat)
  1081. {
  1082.     /* Determine the order of the date. */
  1083.     var cOrder = "";
  1084.     for (var i = 0; i < cFormat.length; i++) {
  1085.         switch (cFormat.charAt(i)) {
  1086.             case "\\":    /* Escape character. */
  1087.                 i++;
  1088.             break;
  1089.             case "m":
  1090.                 if (cOrder.indexOf("m") == -1)
  1091.                     cOrder += "m";
  1092.             break;
  1093.             case "d":
  1094.                 if (cOrder.indexOf("d") == -1)
  1095.                     cOrder += "d";
  1096.             break;
  1097.             case "y":
  1098.                 if (cOrder.indexOf("y") == -1)
  1099.                     cOrder += "y";
  1100.             break;
  1101.         }
  1102.     }
  1103.  
  1104.     /* Make sure we have a full complement of 3 chars. */
  1105.     if (cOrder.indexOf("m") == -1)
  1106.         cOrder += "m";
  1107.     if (cOrder.indexOf("d") == -1)
  1108.         cOrder += "d";
  1109.     if (cOrder.indexOf("y") == -1)
  1110.         cOrder += "y";
  1111.  
  1112.     return cOrder;
  1113. }
  1114.  
  1115. function AFDate_FormatEx(cFormat)
  1116. {    /* cFormat is a format string with which the date is to be formatted. */
  1117.     if (!event.value) 
  1118.         return;    /* Blank fields remain blank */
  1119.  
  1120.     var date = AFParseDateEx(event.value, cFormat);
  1121.     if (!date) {
  1122.         event.value = "";
  1123.         return;
  1124.     }
  1125.     
  1126.     event.value = util.printd(cFormat, date);
  1127. }
  1128.  
  1129. function AFDate_Format(pdf)
  1130. {    /* OBSOLETE: Use AFDate_FormatEx. */
  1131.     var cOldFormats = new Array(
  1132.         "m/d", "m/d/yy", "mm/dd/yy", "mm/yy", "d-mmm", "d-mmm-yy", "dd-mmm-yy",
  1133.         "yy-mm-dd", "mmm-yy", "mmmm-yy", "mmm d, yyyy", "mmmm d, yyyy",
  1134.         "m/d/yy h:MM tt", "m/d/yy HH:MM" );
  1135.  
  1136.     AFDate_FormatEx(cOldFormats[pdf]);
  1137. }
  1138.  
  1139. function AFTime_Format(ptf)
  1140. {    /* This function formats a time value according to the "PropsTimeFormat" parameter ptf.
  1141.     ** The time formats, indicated by ptf, are:
  1142.     ** ptf             format                                                          
  1143.     ** ---             ------                                                          
  1144.     ** 0               PTF_24HR_MM     [ 14:30      ]
  1145.     ** 1               PTF_12HR_MM     [ 2:30 PM    ]
  1146.     ** 2               PTF_24HR_MM_SS  [ 14:30:15   ]
  1147.     ** 3               PTF_12HR_MM_SS  [ 2:30:15 PM ] */
  1148.  
  1149.     if(!event.value) return;    /* Blank fields remain blank */
  1150.  
  1151.     var date = new AFParseTime(event.value, null);
  1152.     if(!date) {
  1153.         event.value = "";
  1154.         return;
  1155.     }
  1156.  
  1157.     var cFormats = new Array(
  1158.         "HH:MM", "h:MM tt", "HH:MM:ss", "h:MM:ss tt" ); 
  1159.     
  1160.     event.value = util.printd(cFormats[ptf], date);
  1161. }
  1162.  
  1163. function AFSignatureLock(doc, cOperation, cFields, bLock)
  1164. {    // Locks or unlocks a set of fields according to the specified operation.
  1165.     /* Field name separator is one or more spaces followed by a comma, 
  1166.     ** followed by one or more spaces.
  1167.     ** or an array of field names */
  1168.      var aFields = AFMakeArrayFromList(cFields);
  1169.  
  1170.     /* Three cases: ALL, EXCEPT, THESE for the field name list. */
  1171.     if (cOperation != "THESE") {
  1172.         for (var i = 0; i < doc.numFields; i++) {
  1173.             var f = doc.getField(doc.getNthFieldName(i));
  1174.                 
  1175.             f.readonly = bLock;
  1176.          }
  1177.     }
  1178.     
  1179.     if (cOperation == "EXCEPT")
  1180.         /* EXCEPT = ALL(lock) then THESE(unlock) */
  1181.         bLock = !bLock;
  1182.  
  1183.     if (cOperation == "THESE" || (cOperation == "EXCEPT" && !bLock)) {
  1184.         for (var i = 0; i < aFields.length; i++) {
  1185.             var f = doc.getField(aFields[i]);
  1186.             var a = f.getArray();
  1187.  
  1188.             for (var j = 0; j < a.length; j++) {
  1189.                 a[j].readonly = bLock;
  1190.             }
  1191.         }
  1192.     }
  1193. }
  1194.  
  1195. function AFSignature_Format(cOperation, cFields)
  1196. {    /* This function is invoked at format time but really is used to lock fields
  1197.     ** in the document. We unlock all the specified fields if the value is
  1198.     ** null (which means the signature hasn't been applied). */
  1199.  
  1200.     var bLock = (event.value != "");
  1201.  
  1202.     AFSignatureLock(this, cOperation, cFields, bLock);
  1203. }
  1204.